home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 25 / CU Amiga Magazine's Super CD-ROM 25 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-08].iso / CUCD / Programming / ixemul / sdk / man / cat8 / ixtimezone.0 < prev    next >
Encoding:
Text File  |  1998-06-15  |  6.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. IXTIMEZONE(8)                                       IXTIMEZONE(8)
  5.  
  6.  
  7. NNAAMMEE
  8.        ixtimezone - allows Unix timezone-handling to be used with
  9.        ixemul.library
  10.  
  11. SSYYNNOOPPSSIISS
  12.        iixxttiimmeezzoonnee option
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        _I_x_t_i_m_e_z_o_n_e uses the TTZZ environment variable  to  determine
  16.        the  offset  in seconds between Universal Coordinated Time
  17.        (aka Greenwich Mean Time) and  the  local  timezone.  This
  18.        offset  is  stored  in a field in the ixemul library base.
  19.        The offset is also written  to  the  environment  variable
  20.        IIXXGGMMTTOOFFFFSSEETT.   The _i_x_e_m_u_l_._l_i_b_r_a_r_y is now able to correctly
  21.        determine the local time and GMT.
  22.  
  23.        The TTZZ environment variable should contain the name of one
  24.        of  the files in the //eettcc//zzoonneeiinnffoo directory. For example,
  25.        I live in the Netherlands, so my TTZZ is set to  EEuurrooppee//AAmmss--
  26.        tteerrddaamm.   The  TTZZ  environment variable _m_u_s_t be set before
  27.        using _i_x_t_i_m_e_z_o_n_e, otherwise _i_x_t_i_m_e_z_o_n_e wouldn't know  what
  28.        the  local  timezone is, and therefore it wouldn't be able
  29.        to compute the offset from GMT.
  30.  
  31.        You should put  _i_x_t_i_m_e_z_o_n_e  in  your  ssttaarrttuupp--sseeqquueennccee  to
  32.        ensure  that  it  is called every time you start your com-
  33.        puter. After _i_x_t_i_m_e_z_o_n_e has been executed, you can set  TTZZ
  34.        to  whatever value you want. For example, to see what time
  35.        it is in Japan, set TTZZ to JJaappaann and type _i_x_t_i_m_e_z_o_n_e _-_t_e_s_t.
  36.        But  don't  use any other option, as the other options set
  37.        the GMT offset based on the current  TTZZ  value,  which  is
  38.        JJaappaann!
  39.  
  40.        Note  that  you  need  to  call this tool at least twice a
  41.        year, when Daylight Saving Time comes in effect  and  when
  42.        it ends.
  43.  
  44. OOPPTTIIOONNSS
  45.        --tteesstt  Print   the   local  time  and  GMT  (according  to
  46.               _i_x_e_m_u_l_._l_i_b_r_a_r_y) to standard output.   Use  this  to
  47.               test  the  current settings. It doesn't affect any-
  48.               thing else.
  49.  
  50.        --ggeett--ooffffsseett
  51.               Calculate the difference between local time and GMT
  52.               in  seconds.  The resulting offset is stored in the
  53.               library base of _i_x_e_m_u_l_._l_i_b_r_a_r_y and is also  written
  54.               to the global environment variable IIXXGGMMTTOOFFFFSSEETT.
  55.  
  56.               If  the  IIXXGGMMTTOOFFFFSSEETT  environment  variable  didn't
  57.               exist or the offset stored in the original environ-
  58.               ment  variable  differed from the new offset (which
  59.               happens when Daylight Saving Time starts or  ends),
  60.               then  a  copy  of  IIXXGGMMTTOOFFFFSSEETT  is  written  to the
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IXTIMEZONE(8)                                       IXTIMEZONE(8)
  71.  
  72.  
  73.               EENNVVAARRCC:: directory.
  74.  
  75.               Since _i_x_e_m_u_l_._l_i_b_r_a_r_y reads the IIXXGGMMTTOOFFFFSSEETT environ-
  76.               ment  variable just after it is loaded into memory,
  77.               it is sufficient to use _i_x_t_i_m_e_z_o_n_e only  when  Day-
  78.               light  Saving  Time  starts  or  ends. Provided, of
  79.               course, that the contents of the EENNVVAARRCC::  directory
  80.               is  copied to EENNVV:: before _i_x_e_m_u_l_._l_i_b_r_a_r_y is loaded.
  81.  
  82.        --cchheecckk--ddsstt
  83.               This option does the same as  --ggeett--ooffffsseett,  but  it
  84.               also detects if Daylight Saving Time has started or
  85.               ended. If so, it automatically sets the Amiga clock
  86.               to  the  correct  time.  So  you  no longer need to
  87.               change the time manually twice a year.
  88.  
  89.        --ppaattcchh--rreessoouurrccee
  90.               This option does the same as  --ggeett--ooffffsseett,  but  it
  91.               also  patches the _b_a_t_t_c_l_o_c_k_._r_e_s_o_u_r_c_e.  This is most
  92.               useful if you also run the Unix operating system on
  93.               your  Amiga  (NetBSD  or  Linux, for example). Unix
  94.               requires that the clock is set  to  Greenwich  Mean
  95.               Time,  while  the  Amiga requires that the clock is
  96.               set   to    local    time.    By    patching    the
  97.               _b_a_t_t_c_l_o_c_k_._r_e_s_o_u_r_c_e  one  can  set  the Amiga clock,
  98.               which is managed by the _b_a_t_t_c_l_o_c_k_._r_e_s_o_u_r_c_e, to  GMT
  99.               time.  The  patch  ensures  that whenever the Amiga
  100.               wants to obtain the time, the GMT time is converted
  101.               into  local  time. There is also no longer any need
  102.               to change the Amiga clock when Daylight Saving Time
  103.               starts  or  ends, since the battery clock is set to
  104.               GMT.
  105.  
  106.               _i_x_t_i_m_e_z_o_n_e  detects  if  you  try  to   patch   the
  107.               _b_a_t_t_c_l_o_c_k_._r_e_s_o_u_r_c_e  a  second  time. It won't patch
  108.               the resource again, but it will check if  the  cur-
  109.               rent GMT offset is still the same as when the patch
  110.               was originally installed. If it  has  changed,  the
  111.               _b_a_t_t_c_l_o_c_k_._r_e_s_o_u_r_c_e offset will also be changed.
  112.  
  113.        --rreemmoovvee--ppaattcchh
  114.               Removes  the _b_a_t_t_c_l_o_c_k_._r_e_s_o_u_r_c_e patch. It checks if
  115.               the patch was really installed before removing  it.
  116.               This option doesn't do anything else.
  117.  
  118. FFIILLEE
  119.        /etc/zoneinfo  standard directory used for created files
  120.  
  121. HHIISSTTOORRYY
  122.        The original idea for the --ppaattcchh--rreessoouurrccee option came from
  123.        the  _u_n_i_x_c_l_o_c_k  utility  written  by  Geert  Uytterhoeven.
  124.        _u_n_i_x_c_l_o_c_k is available on Aminet.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IXTIMEZONE(8)                                       IXTIMEZONE(8)
  137.  
  138.  
  139. SSEEEE AALLSSOO
  140.        The  time functions, the timezone databases and the _z_i_c(8)
  141.        utility for compiling the timezone files in the //eettcc//zzoonnee--
  142.        iinnffoo directory are available from _e_l_s_i_e_._n_c_i_._n_i_h_._g_o_v in the
  143.        //ppuubb directory.
  144.  
  145. AAUUTTHHOORR
  146.        Hans Verkuil (_h_a_n_s_@_w_y_s_t_._h_o_b_b_y_._n_l)
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.